home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat3 / Tcl / appinit.z / appinit
Text File  |  1998-10-30  |  5KB  |  133 lines
  1.  
  2.  
  3.  
  4. TTTTccccllll____AAAAppppppppIIIInnnniiiitttt((((3333TTTTccccllll))))                                            TTTTccccllll____AAAAppppppppIIIInnnniiiitttt((((3333TTTTccccllll))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      Tcl_AppInit - perform application-specific initialization
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ttttccccllll....hhhh>>>>
  13.  
  14.      int
  15.      TTTTccccllll____AAAAppppppppIIIInnnniiiitttt(_i_n_t_e_r_p)
  16.  
  17. AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  18.      Tcl_Interp   *_i_n_t_e_r_p   (in)      Interpreter for the application.
  19.  
  20.  
  21. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  22.      TTTTccccllll____AAAAppppppppIIIInnnniiiitttt is a ``hook'' procedure that is invoked by the main programs
  23.      for Tcl applications such as ttttccccllllsssshhhh and wwwwiiiisssshhhh.  Its purpose is to allow new
  24.      Tcl applications to be created without modifying the main programs
  25.      provided as part of Tcl and Tk.  To create a new application you write a
  26.      new version of TTTTccccllll____AAAAppppppppIIIInnnniiiitttt to replace the default version provided by
  27.      Tcl, then link your new TTTTccccllll____AAAAppppppppIIIInnnniiiitttt with the Tcl library.
  28.  
  29.      TTTTccccllll____AAAAppppppppIIIInnnniiiitttt is invoked after by TTTTccccllll____MMMMaaaaiiiinnnn and TTTTkkkk____MMMMaaaaiiiinnnn after their own
  30.      initialization and before entering the main loop to process commands.
  31.      Here are some examples of things that TTTTccccllll____AAAAppppppppIIIInnnniiiitttt might do:
  32.  
  33.      [1]  Call initialization procedures for various packages used by the
  34.           application.  Each initialization procedure adds new commands to
  35.           _i_n_t_e_r_p for its package and performs other package-specific
  36.           initialization.
  37.  
  38.      [2]  Process command-line arguments, which can be accessed from the Tcl
  39.           variables aaaarrrrggggvvvv and aaaarrrrggggvvvv0000 in _i_n_t_e_r_p.
  40.  
  41.      [3]  Invoke a startup script to initialize the application.
  42.  
  43.      TTTTccccllll____AAAAppppppppIIIInnnniiiitttt returns TCL_OK or TCL_ERROR.  If it returns TCL_ERROR then it|
  44.      must leave an error message in _i_n_t_e_r_p->_r_e_s_u_l_t;  otherwise the result is  |
  45.      ignored.                                                                 |
  46.  
  47.      In addition to TTTTccccllll____AAAAppppppppIIIInnnniiiitttt, your application should also contain a       |
  48.      procedure mmmmaaaaiiiinnnn that calls TTTTccccllll____MMMMaaaaiiiinnnn as follows:                           |
  49.  
  50.           Tcl_Main(argc, argv, Tcl_AppInit);                                  |
  51.  
  52.      The third argument to TTTTccccllll____MMMMaaaaiiiinnnn gives the address of the application-     |
  53.      specific initialization procedure to invoke.  This means that you don't  |
  54.      have to use the name TTTTccccllll____AAAAppppppppIIIInnnniiiitttt for the procedure, but in practice the  |
  55.      name is nearly always TTTTccccllll____AAAAppppppppIIIInnnniiiitttt (in versions before Tcl 7.4 the name   |
  56.      TTTTccccllll____AAAAppppppppIIIInnnniiiitttt was implicit;  there was no way to specify the procedure     |
  57.      explicitly).  The best way to get started is to make a copy of the file  |
  58.      ttttccccllllAAAAppppppppIIIInnnniiiitttt....cccc from the Tcl library or source directory.  It already       |
  59.      contains a mmmmaaaaiiiinnnn procedure and a template for TTTTccccllll____AAAAppppppppIIIInnnniiiitttt that you can    |
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. TTTTccccllll____AAAAppppppppIIIInnnniiiitttt((((3333TTTTccccllll))))                                            TTTTccccllll____AAAAppppppppIIIInnnniiiitttt((((3333TTTTccccllll))))
  71.  
  72.  
  73.  
  74.      modify for your application.
  75.  
  76.  
  77. KKKKEEEEYYYYWWWWOOOORRRRDDDDSSSS
  78.      application, argument, command, initialization, interpreter
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.